---
order: 1
title: 方向光
type: 图形
group: 光照
label: Graphics/Light
---

**方向光**表示的是光线从以某个方向均匀射出，光线之间是平行的，太阳照射在地球表面的光可以认为是方向光，因为太阳和地球距离的远大于地球半径，所以照射在地球的阳光可以看作是来自同一个方向的一组平行光，即方向光。

<Image src="https://gw.alipayobjects.com/zos/OasisHub/a7f8b3f7-1a5f-4a56-8e57-1636a72aa1fb/image-20240319173643671.png" alt="image-20240319173643671" style={{ zoom: "50%" }} />


| 属性         | 作用                                                                      |
| :----------- | :------------------------------------------------------------------------ |
| Color        | 控制平行光的颜色，默认白色                                                |
| Culling Mask | 控制灯光需要照亮的物体，默认 Everything。 需要配合 Entity 的 Layer 来使用 |

> 方向光可以投射阴影，相关配置参考[阴影文档](/docs/graphics/light/shadow)。

## 脚本使用

```typescript
const lightEntity = rootEntity.createChild("light");
const directLight = lightEntity.addComponent(DirectLight);

// 调整颜色
directLight.color.set(0.3, 0.3, 1, 1);

// 调整方向
lightEntity.transform.setRotation(-45, -45, 0);
```
